Whiteline: Alpha

home *** CD-ROM | disk | FTP | other *** search

/ Whiteline: Alpha / Whiteline Alpha.iso / progtool / forth / doc / files.doc < prev next >

Wrap

Text File | 1994-09-22 | 16.9 KB | 455 lines

0660000020266 1 2Seite # 9[....................................................] êFileinterfacefürdasVoksforth83 ÇêaufdemAtariST ÇêGettingstartedÇ BevorSiedasGlossarlesen,solltenSiediesekleineEinführung lesenundaufeinerleerenDiskettedieBeispieleausprobieren. êWieerzeugeicheinFile,indasicheinProgrammeingebenkann?Ç GebenSiebittefolgendesein: MAKEFILEtest.scr DasFiletest.scrwirdaufdemLaufwerkerzeugt,aufdemSie dasForthgebootethaben. AlsnächstesschätzenSiebitteab,wielangIhrProgramm etwawird.BeachtenSiedabeibitte,daßderScreen0eines FilesfürHinweisezurHandhabungihresProgrammsundder Screen1füreinensog.Loadscreen(dasisteinScreen,der denRestdesFileslädt)reserviertsind.WollenSiealso z.B.3ScreensProgrammeingeben,somußdasFile5Screens langsein;Siegebenalsoein: 5MORE Fertig!SiehabenjetzteinFile,dasdieScreens0..4 enthält.GebenSiejetzt 1L ein.SieeditierenjetztdenScreen1IhresneuenFiles test.scr.Siekönnen,fallsderPlatznichtausreicht,Ihr FilespätereinfachmitMOREverlängern.EinFilekann leidernichtverkürztwerden. ê WiesprecheicheinbereitsaufderDiskettevorhandenesFilean? ÇDasgehtnocheinfacher.GebenSieeinfachdenFilenamenein. ReagiertdasSystemmitderMeldung"Haeh?",sokenntdas ForthdiesesFilenochnicht.SiemüssenindiesemFalldas WortUSEvordemFilenameneingeben,alsoz.B. USEtest.scr JetztkönnenSiewieobenbeschriebenmit1L(odereiner anderenZahl)dasFileeditieren.DasWortUSEerzeugt übrigensimForthsystemdasWortTEST.SCR,fallsesnoch nichtvorhandenwar.WissenSiealsonichtmehr,obSieein Fileschonbenutzthaben,sokönnenSiemitWORDS nachsehenoderdasWort USE voranstellen. ê ♪≈WieerzeugeichFilesaufeinemvorgegebenemLaufwerk,z.B.A:? ÇEntwederdurchVoranstellendesPfadnamensoderdurchEingabe von: A: HierbeiwirdA:zumaktuellenLaufwerkgemacht. êWiesprecheichDirectoriesan? Ç HierbeigibtesverschiedeneMethoden.FürdenAnfang versuchenwir,FilesineinemDirectory"test.dir"zusuchen bzw.zuerzeugen.DazugebenSieein: dirtest.dir Jetztwerdenintest.diralleFilesundDirectorieserzeugt undgesucht.IstdasDirectory"test.dir"nochnicht vorhanden,soerzeugenSieesmit: makedirtest.dir AnschließendkönnenSiewiederDIRbenutzen. ê0)Allgemeines Ç ImfolgendenwirddieBenutzungdesFileinterfacesbeschrieben. DiesesFileinterfacebenutztdieFilesdesGEM-Dosunddessen Subdirectories. BenutztmaneinFilevonForthaus,sowirdesinBlöckezuje 1024Bytesaufgeteilt,dieingewohnterWeiseanzusprechensind. DiestrifftauchfürFileszu,dienichtvomForthauserzeugt wurden.AlsKonventionwirdvorgeschlagen,daßFiles,dieForth- Screens,alsoQuelltexte,enthalten,mit.SCRerweitertwerden. Files,dieDatenenthalten,dienichtunmittelbarlesbarsind, solltenauf.BLKenden. ZumUmschaltenvomFilesystemaufDirektzugriffundumgekehrtgibt esdasWort DIRECT (--) schaltetaufDirektzugriffum.AufdenFilezugriffschalten wirdurchdasNenneneinesFilenamensum. 1)êDerDirectory-MechanismusÇ DieVerwaltungvonDirectoriesentsprichtinetwaderdesGEM-Dos Command-interpretersCOMMAND.PRG PATH(--) DiesesWortgestattetes,mehrereDirectoriesnacheinemzu öffnendenFiledurchsuchenzulassen.Dasistdann praktisch,wennmanmitmehrerenFilesarbeitet,diesichin verschiedenenDirectoriesoderDiskstationenbefinden.Es wirdindenfolgendenFormenbenutzt: PATHdir1;dir2;.... Hierbeisind<dir1>,<dir2>etc.Pfadnamen.WirdeinFileauf demMassenspeichergesucht,sowirdzunächst<dir1>,dann <dir2>etc.durchsucht.ZumSchlußwirddasFiledannim aktuellenDirectory(sieheDIR)gesucht.BeachtenSiebitte, daßkeineLeerzeicheninderReihederPfadnamenauftreten dürfen. Beispiel:PATHA:\;B:\COPYALL.DEM;\AUTO\ IndiesemBeispielwirdzunächstdieDiskstationA,dann dasDirectoryCOPYALL.DEMaufDiskstationBund schließlichdasDirectoryAUTOaufdemaktuellen Laufwerk(sieheSETDRIVE,A:undB:)gesucht.Beachten SiebittedasZeichen"\"vorundhinterAUTO.Das vordereZeichen"\"stehtfürdasHauptdirectory.Wird esweggelassen,sowird AUTO\ andasmit DIR  gewählteDirectoryangehängt.DashintereZeichen"\" trenntdenFilenamenvomPfadnamen. AußerdemkönnenSieeingeben: PATH; IndiesemFallwerdenallePfadegelöschtundeswirdnur nochdasaktuelleDirectorydurchsucht. Schließlichgehtnoch: PATH DanndrucktPATHdieReihederPfadnamenaus. DiesesWortentsprichtdemKommandoPATHdesKommando- inteters. MAKEDIR cccc (--) ErzeugtimaktuellenDirectory(sieheDIR)einDirectorymit NamenCCCC. DiesesWortentsprichtdemKommandoMDdesKommando- interpreters. A: (--) MachtdieDiskstationA:zumaktuellenLaufwerk(siehe SETDRIVE). DiesesWortentsprichtdemKommandoA:desKommando- interpreters. B: (--) MachtdieDiskstationB:zumaktuellenLaufwerk(siehe SETDRIVE). DiesesKommandoentsprichtdemKommandoB:desKommando- interpreters. SETDRIVE (n--) MachtdieDiskstationmitderNummernzuaktuellenLaufwerk. Hiebeientsprichtn=0derDiskstationA,n=1derDiskstation Busw. AufdemaktuellenLaufwerkwerdenFilesundDirectories erzeugt(undnachDurchsuchenvonPATHgesucht).Das Directory,indemFileserzeugtwerden,wirdmitDIR angegeben. ♪≈DIR (--) WirdindenfolgendenFormenbenutzt: DIRcccc <cccc>isteinPfadname,andenneuzuerzeugendeFilesund Directoriesangehängtwerden. Beispiel: A:DIRAUTO erzeugtallefolgendenFilesimDirectoryAUTOaufder DiskstationA.In<cccc>könnenallevomGEM-Dos zugelassenenZeichenaußerLeerzeichenverwendetwerden. Außerdemgehtnoch DIR ohneweitereEingabenwirdderaktuelleSuchpfad einschließlichdesLaufwerksangezeigt. DiesesWortentsprichtdemKommandoCDdesKommando- interpreters. FILES (--) ListetdenInhaltdesaktuellenDirectories(sieheDIRund SETDRIVE)aufdemBildschirmauf.Verweiseaufandere DirectorieswerdendurchdasvomGEM-DesktopbekannteSymbol dargestellt. DiesesWort,zusammenmitdemWortFILES"entsprichtdem KommandoDIRdesKommandointerpreters. FILES" (--) BenutztinderForm FILES"cccc" ListetdieFilesauf,derenNameCCCCist.DerStringCCCC darfdiebekanntenWildcardssowieeinenPfadnamenenthalten. WirdkeinPfadnamebzw.Laufwerkangegeben,sowerdendie FilesdesaktuellenDirectoriesbzw.Laufwerksausgegeben. SAVESYSTEM(--) BenutztinderForm SAVESYSTEM<name> DamitläßtsicheinFORTH-SystemimgegenwärtigenZustand unterdemNamen<name>abspeichern.DiesesWortwirdbenutzt, umfertigeApplikationenzuerzeugen.IndiesemFallsollte dasWort,dasdieApplikationausführt,in'COLDgepatched werden.EinBeispiel:SiehabeneinKopierprogramm geschrieben;dasobersteausführendeWortheißtCOPYDISK.Mit derSequenz 'COPYDISKIS'COLD<Return> SAVESYSTEMCOPY.PRG<Return> erhaltenSieeinProgammnamensCOPY.PRG,dassofortbeim StartCOPYDISKausführt. ê2)FilesÇ FilesbestehenauseinemForthnamenundeinemGEM-Dos-Namen,die nichtübereinstimmenmüssen. IstdasForthwort,unterdemeinFilezugreifbarist,gemeint,so wirdimfolgendenvomêForthfileÇgesprochen.IstdasFileaufder Diskettegemeint,dasvomGEM-Dosverwaltetwird,sowirdvomêGEM- FileÇgesprochen.DurchdasNennendesForthnamenswirddas Forthfile(unddaszugeordneteGEM-File)zumêaktuellenFileÇ,auf dassichalleOperationenwieLIST,LOAD,CONVEYusw.beziehen. BeimÖffneneinesFileswirddiemitPATHangegebeneFolgevon Pfadnamendurchsucht.IsteinFileeinmalgeöffnet,sokanndiese Folgebeliebiggeändertwerden,ohnedaßderZugriffaufdasFile behindertwird.AusSicherheitsgründenempfiehltessichaber, Filessooftundsolangewieirgendmöglichgeschlossenzu halten.DannkanneineÄnderungderFolgevonPfadnamendazu führen,daßeinFilenichtmehrgefundenwird. FILE (--) WirdinderForm: FILE<name> benutzt. ErzeugteinForthwortmitNamen<name>.Wird<name>später ausgeführt,sovermerktessichalsaktuellesFile..Ebenso vermerktessichalsFROMFILE,wasfürCONVEYwichtigist. EinemForthfilewirdmitMAKEoderASSIGNeinGEM-File zugeordnet. MAKE (--) WirdinderForm: MAKEcccc benutzt.ErzeugteinGEM-FilemitNamenccccim aktuellenDirectoryundordnetesdemaktuellenForthfilezu. DasFilewirdauchgleichgeöffnet.EshatdieLängeNull (sieheMORE). Beispiel:FILEtest.scr test.scrMAKEtest.scr erzeugteinForthwortTEST.SCRundeinFilegleichenNamens. AlleOperationenwieLOAD,LISTusw.beziehensichnunauf denentsprechendenScreeninTEST.SCR.BeachtenSiebitte, daßdiesesFilenochleeristunddahereineFehlerbedingung besteht,wennZugriffsoperationenausgeführtwerdensollen. ♪≤MAKEFILE (--) WirdinderfolgendenFormbenutzt: MAKEFILE<name> ErzeugteinForthfilemitNamen<NAME>underzeugt anschließendeinGEM-FilemitdemselbenNamen.DieSequenz FILE<name> <name>MAKE<name> würdegenaudasselbebewirken. ASSIGN (--) WirdinderForm ASSIGNcccc benutzt.OrdnetdemaktuellenFiledasGEM-FilemitNamen CCCCzu.EineFehlerbedingungbesteht,wenndasFilenicht gefundenwerdenkann. USE (--) êDiesesWortistdaswichtigsteWortzumAuswählenvonFiles. Ç EswirdinderfolgendenFormbenutzt: USE<name> DiesesWortmachtdasFilemitNamen<NAME>zumaktuellen File,aufdassichLOAD,LISTusw.beziehen.Eserzeugtein ForthfilemitNamen<NAME>,fallsderNamenochnicht vorhandenwar. AnschließendwirddasFileindenDirectories,diemitPATH angegebenwurden,gesucht.Wirdesdortnichtgefunden,wird dasmitSETDRIVE(bzw.A:undB:)undDIRangegebene Directorydurchsucht.WirdauchdortkeinGEM-DosFilemit demNamen<NAME>gefunden,sowirddieFehlermeldungFILE NOTFOUNDausgegeben.Das(automatisch)erzeugteForthfile verbleibtimDictionaryundmußggf.mit FORGET vergessen werden. CLOSE (--) SchließtdasaktuelleFile.Dabeiwirddas InhaltsverzeichnisderDisketteaktualisiertunddiesog. Handlenummerwiederfreigegeben.Eswerdendiezudiesem FilegehörendengeändertenBlöckeaufdieDiskette zurückgeschriebenundallezudiesemFilegehörendenBlöcke gelöscht. OPEN (--) ÖffnetdasaktuelleFile.EineFehlerbedingungbesteht,wenn dasFilenichtgefundenwerdenkann.DieBenutzungdieses WortesistindenmeistenFällenüberflüssig,daFiles automatischbeieinemZugriffgeöffnetwerden. ♪⌠FROM (--) WirdinderfolgendenFormbenutzt: FROM<name> <NAME>istderNameeinesForthfiles,ausdembeimAufruf vonCONVEYundCOPYBlöckeherauskopiertwerdensollen. Beispiel:filea1FROMfileb3copy KopiertdenBlock1ausFILEBaufdenBlock3vonFILEA. DiesesWortbenutzt USE umdasFileauszuwählen.Das bedeutet,daß fileb automatischalsForthfileangelegtwird, wennesnochnichtimSystemvorhandenist. LOADFROM(n--) WirdinderfolgendenFormbenutzt: LOADFROM<name> <NAME>istderNameeinesForthfiles,ausdemderBlockn geladenwird. Beispiel:15LOADFROMfilea LädtdenBlock15ausFILEA.DiesesWortistwichtig,wenn währenddesLadenseinesFilesTeileeinesanderenFiles geladenwerdensollen.DamitkanndieFunktioneinesLinkers imitiertwerden.DiesesWortbenutzt USE ,um filea zu selektieren.Dasbedeutet,daßautomatischeinForthfilemit Namen filea erzeugtwird,fallsesimSystemnochnicht vorhandenwar. BeachtenSiebitte,daßdiesesWortnichtsmitFROModer FROMFILEzutunhat,obwohlesähnlichheißt! INCLUDE (--) WirdinderfolgendenFormbenutzt: INCLUDE<name> <NAME>istderNameeinesForthfiles,dasvollständiggeladen wird.DabeiistVoraussetzung,daßaufScreen1diesesFiles Anweisungenstehen,diezumLadenallerScreensdiesesFiles führen.SieheauchLOADFROM. CAPACITY (--u) uistdieLängedesaktuellenFiles.BeachtenSiebitte,daß dieLängedesFilesumeinsgrößeristalsdieNummerdes letztenBlocks,daderBlock0mitgezähltwird. FORTHFILES (--) DruckteineListeallerForthfiles,zusammenmitdenNamen derzugehörigenGEM-Files,derenLängeundHandlenummeraus. FROMFILE (--addr) AddristdieAdresseeinerVariablen,dieaufdasForth-File zeigt,ausdemCONVEYundCOPYBlöckelesen.Sieheauch FROM.BeiNenneneinesForth-FileswirddieseVariable gesetzt. ♪ⁿLOADFILE (--addr) AddristdieAdresseeinerVariablen,dieaufdasForth-File zeigt,dasgeradegeladenwird.DieseVariablewirdbei AufrufvonLOAD,THRUusw.aufdasaktuelleFilegesetzt. ISFILE (--addr) addristdieAdresseeinerVariablen,dieaufdasaktuelle Forth-Filezeigt.SiewirdbeiAusführeneinesForth-Files gesetzt. FILE? (--) DrucktdenNamendesaktuellenForthfiles. MORE (n--) VerlängertdasaktuelleFileumnScreens.DieScreens werdenhintenangehängt.AnschließendwirddasFile geschlossen. (MORE(n--) WieMORE,jedochwirddasFilenichtgeschlossen. EOF(--f) fisteinFlag,daswahrist,fallsüberdasEndedesFiles hinausgelesenwurde.fistfalsch,fallsaufdaszuletzt geleseneByteimFilenochweitereBytesfolgen. ê3)VerschiedenesÇ BeimVergesseneinesForth-FilesmitHilfevonFORGET,EMPTYusw. werdenautomatischalleBlockpuffer,dieausdiesemFilestammen, gelöscht,und,wennsiegeändertwaren,aufdieDiskette zurückgeschrieben.DasFilewirdanschließendgeschlossen. BeiVerwendungvonFLUSHwerdenalleFilesgeschlossen.FLUSH sollteüVORÇjedemDiskettenwechselausgeführtwerden,undzwar nichtnur,umdiegeändertenBlöckezurückzuschreiben,sondern auchdamitalleFilesgeschlossenwerden.SindnämlichFiles gleichenNamensaufderneuenDiskettevorhanden,sowirdsonst eineabweichendeLängedesneuenFilesvomForthnichterkannt. BeiVerwendungvonVIEWwirdautomatischdasrichtigeFile geöffnet.